A.C.E. 2

home *** CD-ROM | disk | FTP | other *** search

/ A.C.E. 2 / ACE CD 2.iso / FILES / DOCS / DIROPUSD.LHA / DirOpusHelp.doc < prev next >

Wrap

Text File | 1994-11-27 | 55.6 KB | 1,304 lines

Directory Opus Help, commands and readme etc Brought to you by LSD! Read Me First Last updated April 24th, 1991 ------------------------------------------------------------------------------ Thank you for purchasing Directory Opus, the most powerful directory utility available on the Amiga. Please take the time to fill out and return the registration card, so that you will be eligible for technical support and notified of any major revisions to Directory Opus. It is important that you read the Directory Opus documentation and the following notes thoroughly before attempting to use Directory Opus. Although Directory Opus is a very powerful program, it is also a very dangerous one if used incorrectly. You should also read any Addenda that may be present on the disk for the latest information about the program. Before using the program, you should make a backup of the distribution disk, and always work off that copy. You are entitled to make TWO backups of the distribution disk for your own use. To make this copy, you should use either the Workbench DiskCopy function, the DiskCopy function in Directory Opus, or another copy program. Configuration files created by earlier versions of Directory Opus (v1.xx) are not compatible with Directory Opus v2.xx. The Convert utility on this disk will convert the old format to a format understandable by Directory Opus v2.xx. You must have the arp.library in your LIBS: directory before Convert will run (consult the Directory Opus manual for more information about arp.library). Directory Opus provides an easy-to-use, intuitive replacement for the AmigaDOS CLI, and is more powerful than the Workbench. Once mastered, it should make your job easier, and using the Amiga more enjoyable. ------------------------------------------------------------------------------ PLEASE READ THIS I know that many people will be turned off by yet another lecture on the evils of piracy, but if you are planning to give copies of this software away, I ask you to at least do me the courtesy of reading this plea. Directory Opus has been under development more or less constantly, for around a year. I have calculated, therefore, that I have spent something in the order of 1500 hours on the programming alone (in terms of a 38 hour week, that equates to about 40 weeks work). Add to this the time spent in testing, arranging the packaging, and other neccessary activities, and the time soon exceeds 2000 hours. The costs involved have been many and varied, from telephone calls and petrol, to the actual materials needed for packinging. To bring Directory Opus to a working state, with presentable packaging has probably cost between $4000 and $5000. Add that to the average wage for 40 weeks work, and we see that the total costs to ME are between $20000 and $25000. Obviously, I now want to get something back for my time, effort and money. You must realise that when you buy Directory Opus, you are not BUYING the software. You are buying the disk the software is stored on, the box it is packaged in and the paper the manual is printed on. You are also buying a LICENCE to use Directory Opus, and a LICENCE to use the information presented in the manual. I still own the software, and therefore, it is theft if you give copies away (you are giving to someone else something that does not belong to you). This is ILLEGAL. The Australian Amiga software industry is small at best. There are very few actual developers working in Australia; most of the software you buy here is from America and Europe. It could take just ONE illegal copy to bring about the downfall of program as a viable commercial product. One illegal copy, once distributed to a pirate network, can spread rapidly over the world. Obviously, the more people that have a free copy of software, the less people are going to pay for it. If developers are not rewarded for their work, they will soon stop developing. Each copy of Directory Opus has its serial number embedded within it. This is almost impossible to remove, as there are many complex checks and encryptions around it. Therefore, any illegal copies of Directory Opus that are found can be traced back to the original purchasers. Of course, this system depends on the purchasers returning their registration cards, but if you do not register, no technical support or updates are available anyway. YOU have paid for this software. Therefore, YOU have the right to use it. Why should someone else who hasn't paid have access to it? You might want just to give one copy to a friend, but can you trust them not to give copies away? It basically means that YOU are paying for other people to have the software. Before this spiel becomes too lengthy, please consider this. Instead of giving copies away, suggest to your friends that they buy the software. If someone wants to see the program, invite them around to your house and show them your original. Or even better, give them a copy of the freely distributable demo version. Please don't pirate this software - it is illegal, as well as being immoral. Software piracy can not be justified, no matter how you look at it. If anyone can justify it, ring me reverse charges and explain it to me. I'm not expecting a marked phone bill increase. Thank you, Jonathan Potter ------------------------------------------------------------------------------ The Hitchhiker's Guide to Directory Opus Addenda V2.05 REL/E 19th May 1991 ------------------------------------------------------------------------------- There was a problem with Auto Diskchange, which has now been fixed. There was also a problem displaying the sizes of directories >9999999 bytes long. That has also been fixed. The PRINT requester has a new gadget at the bottom : Draft/NLQ. NLQ is now gone from the style gadgets. The four settings of the new gadget are Draft, NLQ, Hdr Draft and Hdr NLQ. Draft will cause the entire document to be printed in draft mode (including headers and footers). NLQ will do likewise except in NLQ. Hdr Draft will cause the headers and footers to be printed in draft mode and the rest of the document in NLQ. Hdr NLQ will cause the headers and footers to be printed in NLQ mode and the rest of the document in Draft. To set the state of Draft/NLQ from ARexx, the SETPRINT1 command takes an extra parameter (0=Draft, 1=NLQ, 2=Hdr Draft, 3=Hdr NLQ). There is another new feature : ALL is also a rmbgadget. Selecting ALL with the right mouse button causes all selected files to be unselected, and vice versa. The ARexx command for this is TOGGLE. ------------------------------------------------------------------------------- V2.05 REL/A 22nd Apr 1991 ------------------------------------------------------------------------------- Introduction This Addenda details modifications and new features added to Directory Opus since the printing of the manual. It covers changes from v2.01 REL/A through to v2.05 REL/A. You MUST have read the manual before reading any further in this document. This Addenda is laid out as if it were a part of the manual, but it is in no way complete, and only describes changes to functions. It does not give complete documentation on the function itself. This document will be incorporated in the manual at the next printing. Further changes before then will be described in a text file on the Directory Opus distribution disk. If you have any questions, comments or suggestions relating to Directory Opus and the documentation, please conact the author at the address below. Jonathan Potter P.O. Box 289 Goodwood, SA 5034 Australia Phone (08) 2932788 FidoNet 3:680/829 Internet jpotter@itd.adelaide.edu.au ------------------------------------------------------------------------------- Chapter 2 Addenda Screen Gadgets ARCHIVE The ARCHIVE gadget allows you to list, extract from or create archives, using the popular archivers Arc, Zoo and LHArc. LHArc is the recommended archiver. The nine call functions used for the archivers (a list, extract and create function for each of the three archivers) are described in the Chapter 6 addenda below. To list an archive, select the archive (or archives) you wish to list, and click on the ARCHIVE gadget with the left mouse button. The archive type is automatically determined, and the archive is listed using the defined call function. You may also list an archive by doubleclicking on it (with File doubleclick turned on in the configuration). To extract an archive, select the archive (or archives) and click on the ARCHIVE gadget with the right mouse button. The default call functions cause the extracted files to be sent to the destination directory (inactive window). To add files to an archive, select the files you wish to add, and click on the ARCHIVE gadget. Unless the FIRST selected file is an archive itself, Directory Opus will assume you wish to add these files to an archive. The default call functions cause you to be prompted for an archive name, and the archived file is written to the destination directory. BYTE If any directories are selected when BYTE is chosen, the directories that do not already have a size displayed (see below) are scanned, and the size of the directory is calculated and displayed. If the directory size for a directory is already displayed, then the directory will not be re-scanned even if it is selected and BYTE is chosen. This could mean that the directory size is inaccurate, especially if any files have been created or deleted in it by another program. Selecting one or more directories, and then clicking on BYTE with the right mouse button (it is also an rmbgadget), will cause the directory sizes (if displayed) to disappear. You can then reselect the directories, choose BYTE (with the left mouse button), and they will be re-scanned. COPY The COPY gadget copies all selected files in the active directory window, to the inactive directory window, keeping the same names. If, however, the COPY gadget is selected with the right mouse button instead of with the left (as an rmbgadget), you will be given the chance to give a new name to each copied file. This has the same effect as copying the files across, and then renaming them. DATESTAMP The DATESTAMP gadget functions slightly differently to what is described in the manual. When you select the gadget, you are presented with a requester, asking you to enter the date and time. This allows you to datestamp files with a date other than the system date. If you wish to use your own date, enter the date and/or time in the format DD-MMM-YY HH:MM:SS. Otherwise, just press return (on a blank string) and the system date and time will be used. NEWCLI The NEWCLI gadget has been removed, to make way for the ARCHIVE gadget. To open a NEWCLI now, you should select the RUN gadget with no files selected. PLAY Double-clicking on an IFF 8SVX file (with File doubleclick enabled) will now play the sampled sound continuously, not exiting until either mouse button is pressed. The PLAY gadget (with the left mouse button) still plays each sound once only, but if the PLAY gadget is selected with the right mouse button (as an rmbgadget), the sounds are looped, and Directory Opus will not proceed on to the next one until the left mouse button is pressed (the right mouse button will abort the PLAY operation). PLAY can now play SoundTracker modules, provided that the streplay.library file is present in the LIBS: directory. Modules are recognised by the mod. prefix in the filename; if the filename does not have this prefix, it will not be played. PARENT The PARENT gadget itself has not changed in operation. However, in response to the requests of several users, two PARENT gadgets have been added at the sides of the directory windows (on the left of the left window, and on the right of the right window). These gadgets are not actually marked as PARENT, but instead form the border of the Directory Opus screen. You may find it easier to use these gadgets to access the parent directory rather than move the mouse down to the PARENT gadget below. These gadgets function in exactly the same way as the PARENT gadget, including taking notice of the Smart parent/root configuration item. PRINT The PRINT routine is now a full-featured text formatter. There are several configuration items in the PRINT requester : Page length : This is the length of each page, in lines. Left margin : This is the position of the left margin, in characters. Right margin : This is the position of the right margin. Tab : This is the number of spaces a tab character is equivalent to. You can have a header and/or a footer printed at the top and bottom of each page if you wish. Both the header and footer can consist of the title, the current date and the page number. You may select any combination of Title, Date and Page # you wish. If none are selected, the header or footer is not printed. You may also select the typestyle of the header and the footer, by clicking on the gadgets that initially say Normal. These allow you to cycle through the various typestyles available : Normal, NLQ, Bold, Italics, Underline, Double strike and Shadow. Note that some printers may not have all these typestyles available. You may enter a title (to be used in the header and footer) in the Title string gadget. Leaving this blank will use the name of the file as a title. The Output gadget allows you to specify where you want the output of the print process to go to. This defaults to PRT:, but you may choose to have the output sent to a disk file. In this case, simply enter the path and the name of the file you wish to print to. The gadget marked Normal at the bottom of the print requester operates in the same way as the header and footer typestyle gadgets, except that it determines the typestyle for the whole document (excluding headers and footers). The gadget next to this one determines whether or not the last page of the file to be printed is followed by a formfeed character, ejecting it. To start the print operation, select the Print gadget. There are three ways to abort a print operation in process. If the print operation has not been spooled to the printer; that is, Directory Opus is frozen, waiting for the printer to finish, just press the left and right mouse buttons together, in the normal fashion. If, however, the file has been spooled to the printer, selecting the PRINT gadget again will allow you to cancel the print. Choosing Quit will also give you the option of cancelling a print operation in process. PRINT will now print text crunched by PowerPacker. The same conditions apply as in READ, except that PRINT will NOT print text that has been encrypted under PowerPacker with a password. If you wish to print encrypted text you will need to READ the file and print from within the text viewer. READ The PowerPacker decrunching routines in the built-in text viewer have been replaced by calls to the powerpacker.library (by Nico Francois). This library is NOT distributed with Directory Opus, so if you wish to read powerpackered text you will need to find a copy of this library and copy it to your LIBS: directory. The powerpacker.library is available on Fish Disk 414 among others. Check your local PD library. SHOW This function will now display Dynamic Hi-Res pictures (4096 colours in high resolution) created by Macro Paint (from Lake Forest Logic). This format is NOT the same as the Dynamic Hi-Res pictures created by NewTek's DigiView, which Directory Opus will not show. ------------------------------------------------------------------------------- Chapter 4 Addenda Configuration Menu Custom Functions The operation of custom functions has changed radically from previous versions. Before, custom functions were run as programs; that is, the program you entered on the call function line was simply run. This led to some severe limitations, namely : a) Maximum function length of 256 characters. b) No input could be typed at the output window. c) The current directory of the function was always set to the boot device. d) The stack of the function was always 4000 bytes. e) The priority of the function was always 0. f) Functions run asynchronously could not have output (or input). In the new approach to custom functions, temporary script files are created in the T: directory. This has many advantages over the previous method, in that the above limitations no longer exist. One of the few disadvantages is a slightly longer operation time, as the script file must be created each time the function is used. This extra time is negligible if the T: directory is assigned to a hard drive, or the RAM disk. If you do not have a hard drive, you should include the line Assign T: RAM: in your startup-sequence. Another disadvantage is that an extra program is needed. This program is called DOpusRT, and can be found in the C directory of the distribution disk. This is only 3K long, and should be copied to your C: directory. The DOpusRT program is called at the end of the script file, and communicates with Directory Opus to inform it when the script file has finished running. This is needed for functions that are not run asynchronously. It also doubles as a new wait command, which is needed for the adjustable close delay (explained later). To take advantage of the current directory changing, adjustable stack and priority, you will need the commands cd, stack and changetaskpri in your C: directory. You will also need the commands run, execute, failat, newcli and endcli. These are almost always present in your C: directory anyway, so you should not need to install them. The options involved in defining a custom gadget are listed in full below. The same options apply to custom menus. Gadget Name This is the actual name of the gadget that will appear on the screen. Call Function This is the AmigaDOS name (including complete path) of the function that is to be called when this gadget is selected. This can contain control sequences, allowing you to do special things with the function. {aTitle} ... The function will ask you for arguments whenever this sequence appears. The Title string is the title that will appear on the argument requester. You can just have {a}, in which case a default title will be used. {d} ... This will insert the path name of the destination directory window into the call function. {dr} ... The same as {d} except that it causes the destination directory to be re-read at the end of the procedure. {Dr} ... This will cause the destination directory to be re-read, but the pathname will NOT be inserted into the call function. {f} ... The name of the first selected entry will be inserted into the call function for this particular time. The entry is deselected. {fu} ... The same as {f} except that the entry is not deselected. {F} ... The names of ALL selected entries are inserted into the call function at this point. The new "script file" approach to custom functions means that if the length of a call function exceeds 256 characters because of a {F} sequence (or for any reason), a new line in the script file is added, containing the next lot of filenames. This means that you can select as many entries as you wish with a {F} sequence, and they will all be accepted. {Fu} ... The same as {F} except that the entries are not deselected. {o} ... The same as {f} except that only the name of the first selected entry is used, without the pathname. {ou} ... The same as {o} except that the entry is not deselected after it is used. {O} ... The same as {F} except that only the names of the selected entries are used, without the pathname. {Ou} ... The same as {O} except that the entries are not deselected after they are used. {s} ... This will insert the path name of the source directory window into the call function. {sr} ... The same as {s} except that it causes the source directory to be re-read at the end of the procedure. {Sr} ... This will cause the source directory to be re-read, but the pathname will NOT be inserted into the call function. Stack size This allows you to set the stack size of the custom function. The minimum and default is 4000 bytes. The documentation of the program you are running should advise you of the best stack size to use. Priority This allows you to determine the priority at which the custom function runs. The default is 0. You should not use anything lower than -10, or higher than 10, except for certain programs (the documentation of the program should advise you of appropriate priorities). Close delay This allows you to set the number of seconds after the function has finished before the output window closes. The default is 2, which means that the output window will close 2 seconds after the function has terminated. If you set the close delay to 0, the output window will close immediately. If you set it to -1, it will wait for you to press the left mouse button before closing. Executable program This allows you to determine whether the function is an Executable program, a Batch file or an ARexx script. The control sequences in the call function (see above) are only taken into account for executables and batch files. All of the flags (see below) are ignored for ARexx scripts. Output window If this is enabled an output window will be opened every time this custom gadget is used. The window will open on the Directory Opus screen, unless the Workbench to front option is turned on, or the Start function asynchronously option is enabled. In this case, it will open on the Workbench screen, and the Workbench screen will be automatically brought to the front. The window is opened using the handle specified by the Output option in the configuration. Start function asynchronously If this is on, the function will be launched as a new process, and Directory Opus will not wait for it to return. If this is the case, and an output window is specified, the output window opens on the Workbench screen. Change to source directory If this is turned on, the current directory of the custom function will be set to the current source directory (active directory window). Change to destination directory If this is turned on, the current directory of the custom function will be set to the current destination directory (inactive directory window). Do all files This causes the function to act on each selected entry in turn, instead of just the first entry. This is used for commands that do not support multiple filenames on the command line, where {F} to send all selected entries would not work. Workbench to front This causes the Workbench screen to be brought to the front when the function is selected. Directory Opus screen to front This causes the Directory Opus screen to be brought to the front when the function has terminated. It is used in conjunction with Workbench to front. It will not work if Start function asynchronously is turned on. There are a couple of other points to be aware of. Because custom functions now run as a script file, they can be aborted like any other script file by pressing CTRL-D. This is only possible if you have an output window selected. If the script file is aborted, the output window effectively turns into a CLI, and as such, you must type endcli to remove the window. Another point is that if the function was not run asynchronously, Directory Opus will be frozen, waiting for the signal back from the DOpusRT program. If you abort the script file before it reaches DOpusRT, Directory Opus will never return. You can force Directory Opus to unfreeze by activating the Directory Opus window and pressing SHIFT-ESC (the shift key in conjunction with the escape key). This also allows you to turn any non-asynchronous function into an asynchronous function, while the function is running. Note that when using NewCLI or NewShell as the Output cmd (described later), an error such as unknown command will abort the script file as well. You should therefore make sure that all your custom functions do not try to run non-existant programs. Drive Gadgets There are now eighteen drive gadgets, instead of the old twelve. They are displayed as three lots of six (as opposed to the two lots of six before). ------------------------------------------------------------------------------- Chapter 6 Addenda Configuring Directory Opus The configuration requester now has two faces. At the bottom left of the requester there is a gadget labelled More Config. Selecting this will display the second configuration requester. This requester allows you to modify the following options : Output Window This allows you to determine whether or not programs launched by doubleclicking or the RUN and EXECUTE gadgets have an output window. Run asynchronously This allows you to determine whether or not programs launched by doubleclicking or the RUN and EXECUTE gadgets are run asynchronously. The same rules apply to output windows with Run asynchronously as with the custom functions (see above). CD source This sets the current directory of programs launched by doubleclicking or the RUN and EXECUTE gadgets to the source directory (active window). CD destination This sets the current directory of programs launched by doubleclicking or the RUN and EXECUTE gadgets to the destination directory (inactive window). Workbench to front This causes the Workbench to be brought to the front whenever a program is launched by doubleclicking or the RUN and EXECUTE gadgets. Dir Opus to front This causes the Directory Opus screen to be brought to the front whenever a program launched by doubleclicking or the RUN and EXECUTE gadgets terminates. Priority This sets the default priority of programs launched by doubleclicking or the RUN and EXECUTE gadgets. Stack This sets the default stack size of programs launched by doubleclicking or the RUN and EXECUTE gadgets. The default and minimum is 4000 bytes. Output This allows you to define the handle used to open the output window for ALL launched programs (custom functions, doubleclicking, RUN and EXECUTE, etc.). Output cmd This allows you to define the command that is used to execute the script file created for ALL launched programs (custom functions, doubleclicking, RUN and EXECUTE, etc.). It defaults to c:NewCLI. If you wish to use a shell instead of a CLI, you should change it to c:NewShell. Likewise, if you wish to use a WShell, you should change it to c:NewWsh. Close delay This allows you to specify the close delay for programs launched by doubleclicking and the RUN and EXECUTE gadgets. This is the amount of time the output window remains after the program has terminated. Archive type This allows you to select the archiver (Arc, Zoo or LHArc) you wish to use to create archives (see the ARCHIVE gadget discussed above). Archive select gadgets There are nine gadgets running down the left hand side of the requester. There are titled Arc/Zoo/LHArc list, extract and add. They allow you to configure the flags, stack, priority and close delay of the nine archiving functions. Selecting one of these gadgets causes the gadgets above to change, to reflect the current state for the function you have chosen. If none of the nine gadgets are selected, the gadgets above reflect the state of programs launched by doubleclicking, and the RUN and EXECUTE gadgets. The only gadgets above that do not change are Output and Output cmd, as these are global and affect all launched programs (including the archivers). Archive call functions Next to each of the archive select gadgets is a string gadget containing the call function for that particular archive function. The default archive call functions are probably acceptable, but you may wish to modify them, if, for instance, you wish to use the public domain program LZ instead of LHArc. An additional configuration item has been added to the first configuration requester. CPU monitor, when turned on, causes Directory Opus to display the current CPU usage (as a percentage) in the clock at the bottom of the screen, and in the clock in the iconified window (if enabled). You may discover some programs (especially communication software) are slowed down slightly by the CPU monitor, but it does not usually cause a problem. ------------------------------------------------------------------------------- Chapter 7 Addenda General Information Directory Sizes When any complete operation is performed on a directory (eg COPY, PROTECT, HUNT, etc.), the total number of bytes in that directory (ie the sum of the lengths of all files in that directory and its subdirectories) is displayed as the size of that directory. This only occurs after a complete operation has been performed; if the operation is aborted midstream (by operator or by error), the size is not shown. ------------------------------------------------------------------------------- Chapter 8 Addenda ARexx Interface AREXX COMMANDS setprint1 [length] [lmargin] [rmargin] [tabs] [style] [formfeed] This allows you to configure the print routine. length = length of the page in lines lmargin = character position of the left margin rmargin = character position of the right margin tabs = number of spaces a tab is equivalent to style = the style the text will be printed in ; Normal=1, NLQ=2, Bold=3, Italics=4, U.line=5, DoubStrk=6, Shadow=7 formfeed = 0=eject page, 1=no eject setprint2 [header] [footer] [hstyle] [fstyle] [title] [output] This allows you to configure the print routine. header = flags to turn on in header (add the chosen ones) ; 0=no header, 1=title, 2=date, 4=page footer = flags to turn on in footer hstyle = the style the header will be printed in ; Normal=1, NLQ=2, Bold=3, Italics=4, U.line=5, DoubStrk=6, Shadow=7 fstyle = the style the footer will be printed in title = the title that will be printed, "" for name of file byte This command has the same effect as selecting the BYTE gadget. unbyte This command has the same effect as clicking BYTE with the right mouse button (see above). lplay <filename> This will play sound files continuously, requiring a mouse button click to proceed to the next one. nncopy <filename> <newname> This allows you to copy all selected files, and will prompt you for a new name for each. If filename is given, just that file is copied. If newname is given with filename, newname is used as the new name. Status commands 64 Custom gadget flags [gadget] This returns the flags of the specified custom gadget. The flags are : Output window 1 Run asynchronously 2 Executable 4 \ Batch file 8 |- these three are mutually exclusive ARexx script 16 / Workbench to front 32 Do all files 64 Dir Opus to front 128 CD source 256 CD destination 512 These flags are then added together into one value. 75 Top text justification This returns a value indicating whether the text in the status bar is centered (0), left-justified (1) or right-justified (2). This can also be set. 76 Close delay This returns or sets the close delay for programs launched by doubleclicking or the RUN and EXECUTE gadgets. 77 Priority This returns or sets the priority for programs launched by doubleclicking or the RUN and EXECUTE gadgets. 78 Stack This returns or sets the priority for programs launched by doubleclicking or the RUN and EXECUTE gadgets. 79 Output cmd This returns or sets the Output cmd, used to launch ALL programs (see above). 80 CD source This returns a boolean value indicating whether CD source is turned on in the configuration (this can also be set). 81 Dir Opus to front This returns a boolean value indicating whether Dir Opus to front is turned on in the configuration (this also can be set). 82 Output Window This returns a boolean value indicating whether Output Window is turned on in the configuration (this can also be set). 83 CD destination This returns a boolean value indicating whether CD destination is turned on in the configuration (this can also be set). 84 Archive type This returns or sets the current archive type : Arc=0, Zoo=1, LHArc=2 85 Archive call function [archiver] This returns or sets the call function used for the archive function specified by archiver. archiver is a value from 0 to 8. 86 Archive close delay [archiver] This returns or sets the close delay used for the archive function specified by archiver. 87 Archive priority [archiver] This returns or sets the default priority of the archive function specified by archiver. 88 Archive stack [archiver] This returns or sets the default stack size of the archive function specified by archiver. 89 Archive flags [archiver] This returns the flags of the specified archive function. The flags are : Output window 1 Run asynchronously 2 Workbench to front 32 Dir Opus to front 128 CD source 256 CD destination 512 These flags are then added together into one value. 90 CPU monitor This returns a boolean value indicating whether the CPU monitor is turned on or not. ------------------------------------------------------------------------------- Commands help! *QUIT This function exits Directory Opus. If the configuration has been changed, you are asked if you wish to save it first.^ *ICONIFY This closes the Directory Opus window and screen, de-allocates all chip memory, and opens a small window on the Workbench screen. This allows you to have Directory Opus constantly available, but using the minimum amount of memory possible. The iconified window can be configured as a 12 or 24 hour clock, no clock, or no window at all (in this case, the only way to re-enter Directory Opus is with the use of the hot keys).^ *ABOUT This function displays some information about the program, including version number and copyright information.^ *CURDIR This function allows you to set the current working directory for Directory Opus. This is needed for some programs, including archive utilities such as Arc and Zoo, that write all their output to files in the current directory.^ *DATE This function allows you to set the system time and date if you do not have a battery backed clock connected.^ *SAVECONFIG This function saves the configuration to the file it was read from initially. When first run, Directory Opus tries to read the configuration from a file called DirectoryOpus.CFG. It first looks in the current directory, and then in the S: directory.^ *SWAPGADGET This allows you to swap the position of two gadgets, to enable you to configure the gadget display to suit your own tastes. To swap two gadgets, select this function, click on the first gadget, and then on the second. You cannot change the position of Drive gadgets. To end the swapping process at any time, press the right mouse button.^ *DEFINEDRIVES This allows you to define your own Drive gadgets. The Drive gadgets are the six gadgets at the extreme left of the gadget display (at the bottom of the screen). There are 12 separate gadgets, although only 6 are visible at once. To access the next 6 gadgets, press and release the right mouse button over the Drive gadgets. You can redefine these to any legal AmigaDOS pathname, not just drives.^ *DEFINEGADGETS This allows you to define one of fourteen custom gadgets. The custom gadgets are the (initially) empty gadgets in the bottom two rows of the gadget display (although their position can be changed by Swap Gadget).^ *DEFINEMENUS This allows you to define one of 80 custom menus, and to change the menu titles. The menus are defined in the same way as custom gadgets are defined.^ *FORMAT Format allows you to format a new disk, to make it suitable for reading and writing. When Format is selected, a requester appears with several gadgets. The gadget labelled DF1: can be clicked on to cycle through drives 0 to 3. Verify allows you to turn verify on or off. If Quick is selected, the disk will just be initialised. This provides an extremely fast way to erase an old disk. If No Icons is selected, the Disk.info, Trashcan.info and Trashcan directory will not be created on the disk.^ *DISKCOPY DiskCopy allows you to copy one disk to another. When DiskCopy is selected, a requester appears with several gadgets. The source and destination gadgets can be clicked on to cycle through drives 0 to 3. If Verify is selected, the copy will be verified after writing.^ *INSTALL Install allows you to make a disk bootable. The DF0: gadget can be clicked on to cycle through drives 0 to 3. If the Check gadget is highlighted, the disk will not be installed, but the existing bootblock will be checked to see if it is a standard AmigaDOS bootblock.^ *ADDBUFFERS This allows you to add cache buffers to the drive currently open in the active directory window. Each cache buffer takes approximately 512 byte of memory. Cache buffers speed up disk access considerably.^ *ASSIGN This allows you to assign a logical device to the directory open in the active directory window. This means that a simple name such as FOO: can be assigned to a long and complicated pathname such as DH0:projects/work/programs/1989/may/foo/.^ *RELABEL This allows you to change the name of the disk that is open in the active directory window.^ *DATESTAMP Datestamp will change the datestamp of all selected files in the active directory window to the current system time and date.^ *PROTECT Protect will change the protection bits of all selected files in the active directory window to those entered in the requester. Allowable bits are hsparwed, short for Hidden Script Pure Archive Read Write Execute Delete. To toggle bits on or off, click on the appropriate gadgets.^ *COMMENT Comment will add the comment entered in the requester to all selected files in the active directory window.^ *ENCRYPT Encrypt allows you to keep important data secret by encrypting files around an entered password. All selected files in the active directory window will be encrypted, and the outputs sent to the inactive directory. If the password starts with a - (minus) character, the file will be decrypted.^ *ADDICON This will add icons to all selected files and directories in the active directory window. Directory Opus automatically senses what sort of file it is (Drawer, Project or Tool) and will add the appropriate icon. You may specify your own icons in the configuration.^ *PRINTDIR This prints the contents of the active directory window to PRT:. You may elect which information to print, including size, protection, date and comment.^ *ALL This function selects all files and directories in the active directory window.^ *NONE This function unselects all files and directories in the active directory window.^ *PARENT This function jumps back to the parent directory of the active directory window.^ *ROOT This function jumps back to the root directory of the active directory window.^ *BYTE This function displays the number of selected files, directories and bytes, and either a Y or N (for yes and no) to indicate whether there is room left in the opposite window to accomodate the selected entries if they were to be copied to the destination.^ *MAKEDIR This function creates a directory in the active directory window.^ *DELETE This function deletes all selected files and directories in the active directory window. CAREFUL! If a directory is not empty, you will be asked for confirmation before it is deleted. You may turn this checking off in the configuration.^ *CLONE This function makes an identical copy of selected files and directories, in the same directory, but with different names.^ *COPY This function copies all selected files and directories in the active directory window to the inactive directory window, keeping the same names. If the gadget is chosen with the right mouse button, you will be able to specify a new name for each file/directory. Both COPY and CLONE preserve the protection bits, datestamp and comment.^ *RENAME This allows you to rename all selected files and directories. You may use a * to specify a pattern. If no *'s are used, you are asked for a new name for each individual file.^ *MOVE This allows you to move all selected files and directories from the active directory window to the inactive window. You CAN move across devices.^ *EDIT This function calls the editor specified by Editor Name, sending it the name of the selected file. If no files are selected, you are asked for a filename to create a new file.^ *RUN This function runs each selected file in turn. You are prompted for any arguments before each file is run. The output window specified by Output Handle is used. If this gadget is pressed with the right mouse button instead of with the left, each selected file is, in turn, executed as a batch file. The output window specified by Output Handle is used. You MUST have the DOS command Execute present in the C: directory. Should you wish to use a CLI instead of Directory Opus, you can open a CLI from within the program. The CLI will be opened using the name given as an output window, and thus you may specify NEWCON:, and make the CLI a Shell. To open a CLI, click on the RUN gadget with no files selected.^ *ARCHIVE This function allows you to automatically list, extract and add to archives created by the programs Arc, Zoo and LHArc. The type of archive is recognised automatically. To list an archive, select the file and click this gadget with the left mouse button. To extract files from an archive, click the gadget with the right mouse button. To add files to an archive, select the files you want, and providing the first file is not an archive itself, the files will be archived. The call functions for the archivers may be changed in the modify requester.^ *PLAY This function allows you to play IFF 8SVX sampled sounds and other files. If the gadget is selected with the right mouse button, you will have to press the left mouse button to stop the current sound. If you have a copy of the public domain STREPLAY.LIBRARY in your LIBS: directory, the PLAY function will also play SoundTracker files.^ *SHOW This function will show each selected file in turn, if the file is an IFF ILBM picture, an icon, or a font. If it is an icon that is being shown, the alternate imagery (if any) can be displayed by pressing return. To leave a picture, press the left mouse button. If the picture has colour cycling defined, you can start and stop cycling with the TAB key. To print the picture, press the P key.^ *READ This function allows you to read a text file using the mouse. To auto-scroll the file, press the left mouse button. The direction and speed can be specified by the Y-position of the mouse. You can also use the cursor keys and the arrow gadgets to move around in the file. To jump to a specified line, click on the number immediately after Lines. To jump to a specified percentage, click on the percentage display. To move up or down a page, click on the U or D gadget, or press that key. To move to the top or bottom, click on T or B, or press that key. To search for a string, press S or click on the S gadget. To print the current page, press C. To print the whole file, press P. To exit, click on the X gadget, or press ESCape, X or Q.^ *HEXREAD This function allows you to hex read a binary file, in the same way as READ functions.^ *SELECT This allows you to select files and directories in the active directory window using wildcards. All standard wildcards are supported (*,~,? etc..) as well as the AmigaDOS wildcards #? and ?.^ *AREXX This allows you to launch an ARexx script or execute an ARexx command from within Directory Opus. See the manual for more information on ARexx.^ *HUNT This allows you to search through all selected directories and their sub-directories for a specified file, or for a group of files specified by wildcard. You may also select an entire device to search by pressing the right mouse button over the S gadget. The standard wildcard characters apply.^ *SEARCH Search allows you to search all selected files for a specified string, which can contain wildcards. If a match is found, you are told which file contains the string, and given the option to automatically read it. If you opt to do this, a search for the string is automatically initiated once the file has been read by the text viewer. You may also specify directories and devices to search.^ *ERRHELP Error Help gives you more information about AmigaDOS error messages and codes than is generally available. When selected, you are asked for the error code. Once this is entered, you are shown the standard error message as well as a description of the error.^ *PRINT Print will print all selected files (to PRT:). If you select this gadget with the right mouse button, there will be no form feed sent after each file. To Hex Print, you must first HEX READ the file, and then press P.^ *DEFAULTS This resets the configuration to the hard-coded default settings. If the configuration has been changed, you are asked if you wish to save it first.^ *LASTSAVED This resets the configuration to the last-saved settings. If the configuration has been changed, you are asked for confirmation before this is done.^ *ILACE This allows you to turn interlace on or off. Turning interlace on will give you a screen twice as high as normal, with the effect that you can see twice as many files at once.^ *FILE2CLCK This allows you to turn File DoubleClick on. If this is turned on, Directory Opus interrogates a file that is doubleclicked on, and if it recognises the file, it performs the default action for that file type. Currently recognised file types are IFF pictures, icons and fonts, IFF sound files and executables. If the file does not meet any of these, it is viewed as a text file. If the file contains any binary, it is hex read.^ *SEPFILES If the Separate Files option is on (checked), directories will be displayed with the drawers alphabetically sorted at the top of the list, and files alphabetically sorted after the directories.^ *HIDBIT AmigaDOS 1.3 has an undocumented protection bit; the H bit (for Hidden). Although unsupported in 1.3, the idea behind this bit is that all files with it set are hidden from the user. This allows you to hide icons and other files that are never directly accessed. If Hidden Bit is turned on in the configuration, Directory Opus will recognise this bit and hide all files that have it set.^ *DYNAMICUD If Dynamic Update is turned on, the bytes free display of the directory windows will be updated whenever a file is copied or deleted.^ *ERRORCHECK If Error Check is turned on, you are given proper error information, and the chance to Try Again, Skip or Abort whenever an error occurs.^ *DELCHECKFILES If this is turned on, you are asked for confirmation every time DELETE is selected.^ *DELCHECKDIRS If this is turned on, you are asked for confirmation before non-empty directories are deleted.^ *DISPLAYINFO If this is turned on, the protection bits, date and comment of each highlighted file will be display in the status bar. If not, a count will be kept of selected files, directories and bytes.^ *EXISTREPLACE If a copy is about to overwrite an old file, you are asked for confirmation before this occurs, if this option is turned on.^ *MDIRICON This allows you to specify whether you want icons to automatically be created, when a directory is created with MAKEDIR.^ *ASYNC This determines whether programs run from Directory Opus, either by the RUN function, or by doubleclicking, are launched as an independent process, which immediately returns control to Directory Opus. If turned off, Directory Opus will be inactive until a run program is exited.^ *WB2FRONT This determines whether the Workbench screen will be brought to the front when programs are run from Directory Opus, either by the RUN function, or by doubleclicking.^ *SMARTPARENT If this is turned on then whenever PARENT or ROOT is chosen, the 10 directory buffers are searched for the parent/root before the directory is actually read again.^ *PRIORITY This allows you to change the priority at which Directory Opus runs within the multitasking Executive. The default priority is 0, which means that it peacefully coexists with everything else. Setting the priority higher means that Directory Opus will not be slowed down much by other tasks, but the performance of other tasks will suffer. It is not suggested that you set the priority higher than 10.^ *FONT This allows you to select a custom font for use on the Directory Opus screen. The font may be any 8 point font. You should enter just the font name (eg topaz), without any .font suffix.^ *OUTPUT This allows you to specify the handle that the output window is opened under, when you select NewCLI from the Various menu, or when a file is Run or Executed.^ *EDITOR This allows you to specify the name of the editor that is invoked when the gadget EDIT is chosen. The name must include the complete pathname. The default is C:Editor.^ *IFFVIEW This function allows you to set the optional name of an IFF viewer. Although Directory Opus has a built in IFF viewer, it does not show every possible format of picture. If you have a picture that is not shown by the built-in viewer, you should set this to the name of the viewer you wish to use.^ *TEXTVIEWER This allows you to use a text viewer other than the built-in one for reading text with the READ function. HEX READ and doubleclicking will still use the default viewer. This function allows you, for instance, to define a text viewer that displays ANSI codes, should you desire this feature.^ *PLAYERNAME This allows you to use an IFF 8SVX player other than the built-in one for playing sampled sounds.^ *SHOWDELAY The show delay setting allows you to show pictures as a slideshow. If set to 0, pictures will wait for you to press a mouse button before continuing. If Show Delay is set to something other than 0, the picture will continue after that time in seconds.^ *TOOLICON This allows you to specify the complete pathname of your own tool icon, which will be used in the ADD ICON procedure.^ *PROJECTICON This allows you to specify the complete pathname of your own project icon, which will be used in the ADD ICON procedure.^ *DRAWERICON This allows you to specify the complete pathname of your own drawer icon, which will be used in the ADD ICON procedure.^ *DEFAULTTOOL This allows you to specify the default tool of the project icon that is created in the ADD ICON procedure. This is only effective if you are using the built in tool icon.^ *HOTKEYCODE This allows you to specify the code that is used for the hot keys (see manual for more information).^ *HOTKEYQUAL This allows you to specify the qualifier that is used for the hot keys (see manual for more information).^ *ICONTYPE This allows you to specify whether you want the Iconified window to contain a clock (12 or 24 hour) and free memory counter, an empty window, or be completely nonexistent. See Iconify for more information.^ *SHOWFREE This allows you to define how free storage on devices is shown, either as bytes, kilobytes/megabytes, blocks, or as a percentage.^ *SCRCLKTYPE This allows you to specify whether the clock at the bottom of the Directory Opus screen is 12 or 24 hour.^ *DOUNTOICONS If this is turned on, then anything that happens to a file or directory (copying, deleting, renaming, etc.) will also happen to its icon (if one exists).^ *HELPFILE This is the name of the optional help file, where help messages are read from. If this is left blank, help messages are disabled.^ *AUTOAREXX This allows you to specify an ARexx script that will be automatically run when Directory Opus starts up.^ *AUTODC If this is enabled, and you have the root directory of a disk drive open in either of the active directory windows, then that directory will be automatically re-read if the disk is changed.^ *CPUMON If this is enabled, the clock at the bottom of the screen and the clock in the iconified window will also contain a CPU monitor, showing the amount of CPU usage (as a percentage).^ *PALETTE This allows you to change the four-colour palette of the Directory Opus screen, by altering the amount of red, green and blue in each colour.^ *DRIVE These are the drive gadgets. Selecting these reads the given device or path into the active directory window.^ *CLOSEDELAY This allows you to specify, in seconds, how long an output window will remain on the screen before it closes. This applies to output windows created by the RUN, EXECUTE and ARCHIVE functions. To wait for a left mouse button click, specify -1 as the close delay.^ *RPRIORITY This allows you to specify the priority of programs run with the RUN, EXECUTE and ARCHIVE functions.^ *STACK This allows you to specify the stack size of programs run with the RUN, EXECUTE and ARCHIVE functions.^ *OUTPUTCMD This allows you to specify the command used to launch programs with. It defaults to NewCLI, but if you wish to use NewShell (to create a shell), you may change it.^ *RCDSOURCE This specifies that the source directory will become the current directory of the launched program (RUN, EXECUTE and ARCHIVE).^ *RDOPUSF This causes the Directory Opus screen to come to the front after a program launched with RUN, EXECUTE or ARCHIVE has terminated.^ *ROUTPUT This allows you to specify whether programs launched with the RUN, EXECUTE and ARCHIVE functions will have output windows.^ *ARCHIVESTR These gadgets allow you to specify the nine call functions for the list, extract and add operations of the three supported archivers.^ *ARCHSEL These gadgets, while turned on, allow you to modify the stack, priority and close delay, as well as flags of the archive functions.^ *RCDDEST This specifies that the destination directory will become the current directory of the launched program (RUN, EXECUTE and ARCHIVE).^ *ARCTYPE This allows you to specify the archiver you wish to be used when archiving files with the ARCHIVE function.^ *CMENU 1 1 This is custom menu 1 item 1. This is an example of a customised help message. Read the instructions for more information.^ *CMENU 4 20 This is custom menu 4 item 20. This is an example of a customised help message. Read the instructions for more information.^ *CGADGET 1 This is custom gadget 1. This is an example of a customised help message. Read the instructions for more information.^ *CGADGET 14 This is custom gadget 14. This is an example of a customised help message. Read the instructions for more information.^ End.